home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / message / msgb3d / readme.txt < prev   
Text File  |  1995-06-08  |  13KB  |  349 lines
  1. ==================================
  2. MsgBox3D 3.10 - The 3D Message Box
  3. ==================================
  4. The MsgBox statement and function provided with Microsoft's 
  5. Visual Basic lacks a three dimensional "look".  MsgBox3D 
  6. replicates the functions provided by VB's MsgBox and adds a 
  7. three dimensional effect.
  8.  
  9. Features:
  10. 1.  Exactly duplicates the VB MsgBox functions.
  11. 2.  Uses the 3D effect found in newer applications.
  12. 3.  Allows for additional, more meaningful user response by 
  13. allowing the command captions to be more descriptive.
  14. 4.  Can be used to provide bilingual messages, with 
  15. corresponding captions.
  16. 5.  Can display alternate icons.
  17. 6.  Can display a 3D title using Ctl3D.DLL
  18. 7.  Can be used to create "Splash Screens".
  19. 8.  A MsgBox Wizard [MsgGen3D.Exe] generates MsgBox Visual 
  20. Basic code.  Thus simplifying the creation of messages.
  21. 9.  Can include a Help button or No buttons.
  22. 10. A MsgBox Conversion Utility [MsgConvt.Exe]
  23.  
  24. ==========================================
  25. MsgBox Wizard - The Generate Code and Demo
  26. ==========================================
  27.  
  28. MsgB3D.Exe is a self extracting zipped file.  The files 
  29. included in MsgB3D.Exe are:
  30.  
  31. MsgGen3D.Exe    Demo Program
  32. MsgBox3D.Hlp    Help File
  33. MsgConvt.Hlp    Conversion Help File
  34. MsgBSubs.Hlp    Subroutines and Functions Help File
  35. ReadMe.Txt    This Read Me File
  36. *.Ico    Several icons used by MsgGen3D
  37. File_id.Diz    A brief description of the product.
  38.  
  39. MsgGen3D uses VBRun300.DLL, ThreeD.VBX, CMDialog.VBX, and 
  40. Ctl3D.Dll.  They are not supplied.
  41.  
  42. You should copy the Help files to your Windows directory.  
  43. Use MsgGen3D to compare the difference between the VB MsgBox 
  44. and the 3D MsgBox.  You can also demo the use of different 
  45. icons, fonts, command captions and include a help button or 
  46. no buttons.
  47.  
  48. Please review the Help files [MsgBox3D.Hlp and MsgConvt.Hlp] 
  49. to learn how to incorporate MsgBox3D into your applications.
  50.  
  51. MsgBox3D will use Ctl3Dv2.DLL or Ctl3D.DLL, if found.  They 
  52. cause MsgBox3D forms to be displayed with a 3D title and 
  53. MsgGen3D's CMDialog forms to be displayed with a 3D effect.
  54.  
  55. ===============
  56. Version History
  57. ===============
  58.  
  59. Version 3.10, 95/06/08
  60. ----------------------
  61. Ctrl-P Prints - MsgBox3D prints the message on the Windows 
  62. default print in response to the user's pressing Ctrl-P.  A 
  63. useful feature for responding to users who have encountered 
  64. an application's error message
  65.  
  66. Minor Enhancements
  67. 1. A mouse click on the lower portion of a NoButton/NoTitle 
  68. message simulates the selection of the message's default 
  69. button.
  70. 2. MB3D_DoHelp now supports the WinHelp Help_Quit command.
  71. 3. MsgBox3D is now available from PsL [Public (software) 
  72. Library] and a demo version is available on America Online.
  73.  
  74. Version 3.00, 95/05/16
  75. ----------------------
  76. MsgConvt Conversion Utility - The conversion utility reads 
  77. your projects and converts MsgBox statements to MsgBox3D 
  78. statements.  See help file MsgConvt.Hlp for details.
  79.  
  80. New Look
  81. No Separator - The message can be created without a separator 
  82. line between the message and command buttons.  A suggestion 
  83. from Jeffrey McManus [72103,3263].
  84.  
  85. Bevel Width - You can specify the command button's bevel 
  86. width.  The Win31 default is 2.  The Win95 setting is 1.  You 
  87. can achieve a Win95 look by setting MB3D_BevelWidth=1.  A 
  88. suggestion from Bruce Nordstrand [100352,176]
  89.  
  90. VB MsgBox Source - MsgGen3D now generates output for the 
  91. standard VB MsgBox.  Suggested by Kip Johnson [76451,3660].
  92.  
  93. Minor Enhancements
  94. 1. MsgBox3D no longer needs constants from VB's Constant.Txt 
  95. file.
  96. 2. An Undo button is added to the message edit screen.
  97. 3. The message form is no longer "outline" if registered with 
  98. Ctl3D.
  99. 4. The MsgBox3D subroutines and functions have been 
  100. documented and distributed in help file MsgBSubs.Hlp.
  101.  
  102. Version 2.80, 95/04/02
  103. ----------------------
  104. MsgGen3D Settings - MsgGen3D options and settings are now 
  105. saved in and Ini file.  The are restored the next time the 
  106. program is executed.
  107.  
  108. MsgNew3D What's New - In prior versions of MsgGen3D, the 
  109. "What's New" messages were always displayed during the 
  110. startup process.  The display of "What's New" messages can 
  111. now be disabled.
  112.  
  113. Version 2.72, 95/03/12
  114. ----------------------
  115. German Captions.  Thanks to Holger Thornagel [100407,356] for 
  116. supplying German equivalent captions used in MsgCap3D.Frm.
  117.  
  118. Version 2.71, 95/03/12
  119. ----------------------
  120. Ctl3D.DLL Old Version - MsgBox3D uses Ctl3D's function 
  121. Ctl3dSubclassDlgExV2 to register the message.  Older versions 
  122. do not provide that function.  MsgBox3D now gets the 
  123. Ctl3D.DLL version [using Ctl3DGetVer] and does not call the 
  124. subclassing function unless the Ctl3D version is 2.0 or 
  125. greater.  Thanks to Dallas Bridge, 100237,3155 for bringing 
  126. the limitation to our attention.
  127.  
  128. Version 2.70, 95/03/06
  129. ----------------------
  130. MB3D_NoTitles.  MsgBox3D can display the message without a 
  131. title.  Support is provided to drag the "no title" message.
  132.  
  133. MB3D_UseCtl3D.  MsgBox3D will use Ctl3D.DLL or the newer 
  134. version, Ctl3DV2.DLL, to display the title with a 3D effect.
  135.  
  136. Message Edit.  Message input is provided via a separate form.  
  137. An Edit button is added to MsgGen3D which pop's up a large 
  138. form into which message test can be entered.
  139.  
  140. Version 2.61, 95/01/31
  141. ----------------------
  142. Single Access Key.  The standard VB message box allows the 
  143. user to press a single access key to respond to a message.  
  144. The user does need to press Alt-Access Key.  For example: 
  145. Pressing "Y" causes the "Yes" action to be selected.  The 
  146. user does not have to press Alt-Y.  The character following 
  147. the ampersand found in the command's caption becomes the 
  148. single character access key.  If more than one command 
  149. contains that character the key is ignored.  This feature is 
  150. added to MsgBox3D in version 2.61 from a suggestion by Nic 
  151. Barnes, 100111,3452.
  152.  
  153. Version 2.60, 95/01/30
  154. ----------------------
  155. MB3D_VGA_Messages.  By design, the width of the message 
  156. created by MsgBox3D considers the screen's resolution.  A 
  157. "wider" message is created on higher resolution screens.  You 
  158. can "force" message to be displayed in VGA resolution width.  
  159. If MB3D_VGA_Messages=True then MsgBox3D will create these 
  160. narrower messages.
  161.  
  162. Version 2.50, 94/12/03
  163. ----------------------
  164. MB3D_Unload.  The MsgBox3D form can now be unloaded, if 
  165. loaded, using MB3D_Unload.
  166.  
  167. MB3D_Zone.  The MsgBox3D message can be centered in a zone.  
  168. Subroutine MB3D_Zone is added.  See Message Location in the 
  169. MsgBox3D.Hlp file.
  170.  
  171. Registration.  MsgBox3D registration is available from 
  172. CompuServe Shareware Registration services.  Use GO SWREG, 
  173. item number 3805.
  174.  
  175. Mouse Snap-To.  The mouse pointer will jump to the default 
  176. button of any dialog box if Snap-To is enabled in the mouse 
  177. driver.  MsgBox3D uses ThreeD.VBX command buttons.  
  178. ThreeD.VBX buttons do not support the Snap-To feature.  
  179.  
  180. One standard VB command button was added to the MsgBox3D form 
  181. in version 2.44.  That button is moved to the center of the 
  182. default message button then set to invisible.  
  183.  
  184. This workaround solves the minor inconsistency between VB's 
  185. MsgBox and MsgBox3D. Thanks go to Helmuth Schutzeich for 
  186. reporting this inconsistency.
  187.  
  188. French Captions.  Thanks to Roger Doyon [74361,3542] for 
  189. supplying French equivalent captions used in MsgCap3D.Frm.
  190.  
  191. Bug.  MsgGen3D always tried to use Ctl3Dv2.  Then goes into a 
  192. loop and can't recover.  Thanks to Helmuth Schutzeich for 
  193. reporting this "serious bug."
  194.  
  195. Version 2.40, 94/10/06
  196. ----------------------
  197. Significantly Improved Performance.  The MsgBox3D form is no 
  198. longer unloaded.  It is hidden instead.  This provides a vast 
  199. improvement in performance.  Almost all code was moved from 
  200. the message form [MsgBox3D.Frm] to the module [MsgBox3D.Bas].  
  201. You can still unload the form by changing one global 
  202. variable.  A suggestion from Art Gravina and Nick Esselman.
  203.  
  204. Help Button or No Buttons.  You can include a Help button or 
  205. have no buttons displayed with the message.  Help button is a 
  206. suggestion from Ed Obeda.  No buttons is a suggestion from 
  207. Nick Esselman.
  208.  
  209. More Icons.  Eight more standard Icons are added.  A 
  210. suggestion from a number of users.
  211.  
  212. Cleaner Message.  The message has been redesigned providing a 
  213. cleaner 3D effect.  Use the new or old design by changing one 
  214. global switch.  A suggestion from Douglas D. Feller
  215.  
  216. New Name.  MsgDmo3D's name is changed to MsgGen3D.  The new 
  217. name reflects the message generation features of the program.
  218.  
  219. Version 2.30, 94/09/08
  220. ----------------------
  221. Generate VB Code.  MsgDmo3D.Exe, the demo program, will 
  222. generate MsgBox3D source code which can be "pasted" into your 
  223. application.  See help topic "Generating MsgBox3D Source 
  224. Code" in the help file for details.
  225.  
  226. Version 2.20, 94/08/17
  227. ----------------------
  228. Add Alternate Icons.  You can select from one of sixteen 
  229. alternate icons, or specify the file name of any icon to be 
  230. displayed by MsgBox3D.  A suggestion from Ed Obeda.
  231.  
  232. Save and Restore MsgBox3D Global Variables.  You can use 
  233. subroutines MB3D_Globals_Save and MB3D_Globals_Restore to 
  234. save and restore the 21 MsgBox3D user definable variables.
  235.  
  236. Version 2.10, 94/07/27
  237. ----------------------
  238. Add "Splash Screen" support.  Use Global MB3D_Splash to pass 
  239. an interval to MsgBox3D.  For example:
  240.       MB3D_Splash = 1000
  241. causes the message to be removed in one second.
  242.  
  243. Version 2.03, 94/06/02
  244. ----------------------
  245. Add "Private" to internal MsgBox3D subroutines and functions.
  246.  
  247. Version 2.02, 94/05/30
  248. ----------------------
  249. A comment in the help file was inaccurate.  A label box, not 
  250. a text box, is used to display non-3D messages.
  251.  
  252. Version 2.01, 94/05/29
  253. ----------------------
  254. Added MB3D_Commands_No3D global variable.  When set to True 
  255. commands are shown without a 3D font.  Suggestion from Louis 
  256. Desjardins.
  257.  
  258. Version 2.00, 94/05/27
  259. ----------------------
  260. Two significant features were added to MsgBox3D in version 
  261. 2.00.  You can now specify the font and alignment used while 
  262. displaying the message.  And you can define the command 
  263. captions and fonts.  For example: The "OK" caption could be 
  264. replaced with "Next Page".  These enhancements are described 
  265. in the demo's What's New screens.  
  266.  
  267. Uses: You could use MsgBox3D as a bilingual enhancement to 
  268. VB's message box.  For example: As the user log's on he 
  269. replies whether he wishes to use the French or English 
  270. version of your application.  You then modify the command 
  271. captions based upon his language preference.
  272.  
  273. Version 1.10, 94/04/10
  274. ----------------------
  275. 1.  Remove VSVBX from the demo program.  
  276.  
  277. 2.  Support the up and down arrow keys while displaying the 
  278. message.  Pressing the up or down arrow keys did not provide 
  279. the same results as the VB MsgBox.
  280.  
  281. Version 1.01, 94/03/04
  282. ----------------------
  283. 1.  Add support for System Modal mode.  With the help of 
  284. Wayne Aiello, MsgBox3D now supports the display of the 
  285. message box in System Modal mode.  The SetSystemModalWindow 
  286. API is used.
  287.  
  288. 2.  MsgBox3D is modified to eliminate the Switch menu entry 
  289. from the control box.  And display the Close menu entry only 
  290. if a Cancel button is displayed.  The GetSystemMenu, 
  291. DeleteMenu and ModifyMenu API's are used.
  292.  
  293. Version 1.00, 94/03/01
  294. ----------------------
  295. Original version completed.  A demo is uploaded to CompuServe 
  296. on 94/03/01.
  297.  
  298. ==============
  299. Upgrade Policy
  300. ==============
  301. See the Upgrade Policy in help file MsgBox3D.Hlp.
  302.  
  303. =================
  304. Ordering MsgBox3D
  305. =================
  306. See Registering and Ordering in help file MsgBox3D.Hlp
  307.  
  308. If you have questions, problems, or suggestions concerning 
  309. MsgBox3D, please contact:
  310.  
  311. The Bridge, Inc.
  312. 913 Hacienda Way
  313. Millbrae, CA  94030
  314. 415-737-0870
  315. Fax: 415-737-0871
  316. CompuServe: 71662,205
  317.  
  318. ==============
  319. Other Products
  320. ==============
  321. Other products available from The Bridge on CompuServe 
  322. include:
  323.  
  324. Holiday Calendar - A full function calendar with holidays 
  325. using DDE.  Use it as a stand alone calendar.  Or use it to 
  326. communicate with your application via DDE.  Holiday 
  327. information is stored in an Access database.  Source code 
  328. available for $19.95.  File name: HolCal.Zip
  329.  
  330. Shade - A demo program that shows how to shade a form - 
  331. similar to the Window's Setup screen.  Freeware.  File name: 
  332. Shade.Zip.
  333.  
  334. SetTab - A demo program that shows how to set tabs in a text 
  335. box.  Freeware.  File name: SetTab.Zip
  336.  
  337. TstLay - Two functions that will save and restore a TrueGrid 
  338. layout in a binary file.  Freeware.  File name: TstLay.Zip.
  339.  
  340. DemoCt3D - Demonstrates the API's needed to call Ctl3D.DLL.  
  341. Freeware.  File name: DmoC3D.Zip
  342.  
  343. UppLow - A demo that uses API's to force the text box to 
  344. convert all data to upper or lower case as it is entered. 
  345. Freeware.  File name: UppLow.Zip
  346.  
  347. Readme.Txt Last Revised: Thursday, June 8, 1995
  348.  
  349.